---
title: Zephyr Cloud에 Astro 사이트 배포
description: Zephyr Cloud를 사용하여 Astro 사이트를 웹에 배포하는 방법
sidebar:
  label: Zephyr Cloud
type: deploy
logo: zephyr
supports: ['static']
i18nReady: true
---

import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro';
import { Steps } from '@astrojs/starlight/components';

[Zephyr Cloud](https://zephyr-cloud.io)를 사용하면 지능형 자산 관리, 포괄적인 빌드 분석, Module Federation 아키텍처에 대한 완벽한 지원을 통해 Astro 사이트를 배포할 수 있습니다.

Zephyr는 **BYOC(Bring Your Own Cloud)** 모델을 기반으로 하며, 공급업체 종속 없이 통합 인터페이스를 통해 [지원되는 클라우드](https://docs.zephyr-cloud.io/cloud)에 선택적으로 배포할 수 있습니다. 배포 워크플로우를 변경하지 않고 언제든지 제공업체를 전환할 수 있습니다.

## 배포 방법

### 자동 설치

<Steps>
1. 다음 명령을 사용하여 Astro 프로젝트에 Zephyr 통합을 추가합니다. 이렇게 하면 통합이 설치되고 `astro.config.mjs` 파일이 자동으로 업데이트됩니다.

    <PackageManagerTabs>
      <Fragment slot="npm">
      ```shell
      npx with-zephyr@latest
      ```
      </Fragment>
      <Fragment slot="pnpm">
      ```shell
      pnpm dlx with-zephyr@latest
      ```
      </Fragment>
      <Fragment slot="yarn">
      ```shell
      yarn dlx with-zephyr@latest
      ```
      </Fragment>
    </PackageManagerTabs>

2. Astro 사이트를 빌드 및 배포합니다.

    <PackageManagerTabs>
      <Fragment slot="npm">
      ```shell
      npm run build
      ```
      </Fragment>
      <Fragment slot="pnpm">
      ```shell
      pnpm run build
      ```
      </Fragment>
      <Fragment slot="yarn">
      ```shell
      yarn run build
      ```
      </Fragment>
    </PackageManagerTabs>

3. 애플리케이션이 배포되었습니다! Zephyr는 배포 URL과 포괄적인 빌드 분석을 제공합니다.
</Steps>

### 수동 설치

<Steps>
1. Zephyr Astro 통합을 설치합니다.

    <PackageManagerTabs>
      <Fragment slot="npm">
      ```shell
      npm install zephyr-astro-integration
      ```
      </Fragment>
      <Fragment slot="pnpm">
      ```shell
      pnpm add zephyr-astro-integration
      ```
      </Fragment>
      <Fragment slot="yarn">
      ```shell
      yarn add zephyr-astro-integration
      ```
      </Fragment>
    </PackageManagerTabs>

2. `astro.config.mjs`에 통합을 추가합니다.

    ```js
    import { defineConfig } from 'astro/config';
    import { withZephyr } from 'zephyr-astro-integration';

    export default defineConfig({
      integrations: [
        withZephyr(),
      ],
    });
    ```

3. Astro 사이트를 빌드 및 배포합니다.

    <PackageManagerTabs>
      <Fragment slot="npm">
      ```shell
      npm run build
      ```
      </Fragment>
      <Fragment slot="pnpm">
      ```shell
      pnpm run build
      ```
      </Fragment>
      <Fragment slot="yarn">
      ```shell
      yarn run build
      ```
      </Fragment>
    </PackageManagerTabs>
4. 애플리케이션이 배포되었습니다! Zephyr는 배포 URL과 포괄적인 빌드 분석을 제공합니다.
</Steps>

### 추가 정보

더 자세한 정보는 [Astro 배포 관련 Zephyr Cloud 문서](https://docs.zephyr-cloud.io/meta-frameworks/astro)를 참조하세요.

## 배포 시 발생하는 일

Zephyr 통합을 사용하여 Astro 사이트를 빌드하면 다음과 같은 프로세스가 진행됩니다.

1. **빌드 컨텍스트 추출**: Zephyr는 Git 정보(커밋, 브랜치, 작성자)와 패키지 메타데이터를 캡처합니다.
2. **자산 해싱**: 모든 빌드 결과물은 콘텐츠 주소 지정 저장을 위해 SHA-256으로 해시됩니다.
3. **차이점 감지**: Zephyr는 CDN 엣지에 쿼리하여 이미 존재하는 자산을 식별합니다.
4. **최적화된 업로드**: 새로 추가되거나 수정된 자산만 업로드됩니다.
5. **스냅샷 생성**: 모든 자산 참조와 함께 불변하는 배포 스냅샷이 생성됩니다.
6. **분석 정보 업로드**: 빌드 통계, 모듈 그래프, 종속성 정보가 대시보드로 전송됩니다.
7. **CDN 배포**: 자산은 영구 캐시 헤더와 함께 구성된 CDN에 게시됩니다.

## 공식 리소스

- [Zephyr Cloud 문서](https://docs.zephyr-cloud.io)
- [Zephyr Astro 통합 GitHub](https://github.com/ZephyrCloudIO/zephyr-packages/tree/main/libs/zephyr-astro-integration)
- [Zephyr Cloud 플랫폼](https://zephyr-cloud.io)
